home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / a_man / cat1 / infocmp.z / infocmp
Encoding:
Text File  |  2002-10-03  |  16.5 KB  |  265 lines

  1.  
  2.  
  3.  
  4. iiiinnnnffffooooccccmmmmpppp((((1111MMMM))))                                                        iiiinnnnffffooooccccmmmmpppp((((1111MMMM))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _iiii_nnnn_ffff_oooo_cccc_mmmm_pppp - compare or print out _t_e_r_m_i_n_f_o descriptions
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _iiii_nnnn_ffff_oooo_cccc_mmmm_pppp [_----_dddd] [_----_cccc] [_----_nnnn] [_----_IIII] [_----_LLLL] [_----_CCCC] [_----_rrrr] [_----_uuuu] [_----_ssss _dddd| _iiii| _llll| _cccc] [_----_vvvv] [_----_VVVV]
  13.            [_----_1111] [_----_wwww _w_i_d_t_h] [_----_AAAA _d_i_r_e_c_t_o_r_y] [_----_BBBB _d_i_r_e_c_t_o_r_y] [_t_e_r_m_n_a_m_e . . .]
  14.  
  15. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  16.      _iiii_nnnn_ffff_oooo_cccc_mmmm_pppp can be used to compare a binary _tttt_eeee_rrrr_mmmm_iiii_nnnn_ffff_oooo entry with other
  17.      terminfo entries, rewrite a _tttt_eeee_rrrr_mmmm_iiii_nnnn_ffff_oooo description to take advantage of the
  18.      _uuuu_ssss_eeee_==== terminfo field, or print out a _tttt_eeee_rrrr_mmmm_iiii_nnnn_ffff_oooo description from the binary
  19.      file (_tttt_eeee_rrrr_mmmm) in a variety of formats.  In all cases, the boolean fields
  20.      will be printed first, followed by the numeric fields, followed by the
  21.      string fields.
  22.  
  23.    DDDDeeeeffffaaaauuuulllltttt OOOOppppttttiiiioooonnnnssss
  24.      If no options are specified and zero or one _t_e_r_m_n_a_m_e_s are specified, the
  25.      _----_IIII option will be assumed.  If more than one _t_e_r_m_n_a_m_e is specified, the
  26.      _----_dddd option will be assumed.
  27.  
  28.    CCCCoooommmmppppaaaarrrriiiissssoooonnnn OOOOppppttttiiiioooonnnnssss [[[[----dddd]]]] [[[[----cccc]]]] [[[[----nnnn]]]]
  29.      _iiii_nnnn_ffff_oooo_cccc_mmmm_pppp compares the _tttt_eeee_rrrr_mmmm_iiii_nnnn_ffff_oooo description of the first terminal _t_e_r_m_n_a_m_e
  30.      with each of the descriptions given by the entries for the other
  31.      terminal's _t_e_r_m_n_a_m_e_s.  If a capability is defined for only one of the
  32.      terminals, the value returned will depend on the type of the capability:
  33.      _FFFF for boolean variables, _----_1111 for integer variables, and _NNNN_UUUU_LLLL_LLLL for string
  34.      variables.
  35.  
  36.      _----_dddd      produces a list of each capability that is different between two
  37.              entries.  This option is useful to show the difference between
  38.              two entries, created by different people, for the same or similar
  39.              terminals.
  40.  
  41.      _----_cccc      produces a list of each capability that is common between two
  42.              entries.  Capabilities that are not set are ignored.  This option
  43.              can be used as a quick check to see if the _----_uuuu option is worth
  44.              using.
  45.  
  46.      _----_nnnn      produces a list of each capability that is in neither entry.  If
  47.              no _t_e_r_m_n_a_m_e_s are given, the environment variable _TTTT_EEEE_RRRR_MMMM will be
  48.              used for both of the _t_e_r_m_n_a_m_e_s.  This can be used as a quick
  49.              check to see if anything was left out of a description.
  50.  
  51.    SSSSoooouuuurrrrcccceeee LLLLiiiissssttttiiiinnnngggg OOOOppppttttiiiioooonnnnssss [[[[----IIII]]]] [[[[----LLLL]]]] [[[[----CCCC]]]] [[[[----rrrr]]]]
  52.      The _----_IIII, _----_LLLL, and _----_CCCC options will produce a source listing for each
  53.      terminal named.
  54.      _----_IIII      use the _tttt_eeee_rrrr_mmmm_iiii_nnnn_ffff_oooo names
  55.      _----_LLLL      use the long C variable name listed in <_tttt_eeee_rrrr_mmmm_...._hhhh>
  56.      _----_CCCC      use the _tttt_eeee_rrrr_mmmm_cccc_aaaa_pppp names
  57.      _----_rrrr      when using _----_CCCC, put out all capabilities in _tttt_eeee_rrrr_mmmm_cccc_aaaa_pppp form
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. iiiinnnnffffooooccccmmmmpppp((((1111MMMM))))                                                        iiiinnnnffffooooccccmmmmpppp((((1111MMMM))))
  71.  
  72.  
  73.  
  74.      If no _t_e_r_m_n_a_m_e_s are given, the environment variable _TTTT_EEEE_RRRR_MMMM will be used for
  75.      the terminal name.
  76.  
  77.      The source produced by the _----_CCCC option may be used directly as a _tttt_eeee_rrrr_mmmm_cccc_aaaa_pppp
  78.      entry, but not all of the parameterized strings may be changed to the
  79.      _tttt_eeee_rrrr_mmmm_cccc_aaaa_pppp format.  _iiii_nnnn_ffff_oooo_cccc_mmmm_pppp will attempt to convert most of the
  80.      parameterized information, but anything not converted will be plainly
  81.      marked in the output and commented out.  These should be edited by hand.
  82.  
  83.      All padding information for strings will be collected together and placed
  84.      at the beginning of the string where _tttt_eeee_rrrr_mmmm_cccc_aaaa_pppp expects it.  Mandatory
  85.      padding (padding information with a trailing '/') will become optional.
  86.  
  87.      All _tttt_eeee_rrrr_mmmm_cccc_aaaa_pppp variables no longer supported by _tttt_eeee_rrrr_mmmm_iiii_nnnn_ffff_oooo, but which are
  88.      derivable from other _tttt_eeee_rrrr_mmmm_iiii_nnnn_ffff_oooo variables, will be output.  Not all
  89.      _tttt_eeee_rrrr_mmmm_iiii_nnnn_ffff_oooo capabilities will be translated; only those variables which were
  90.      part of _tttt_eeee_rrrr_mmmm_cccc_aaaa_pppp will normally be output.  Specifying the _----_rrrr option will
  91.      take off this restriction, allowing all capabilities to be output in
  92.      _t_e_r_m_c_a_p form.
  93.  
  94.      Note that because padding is collected to the beginning of the
  95.      capability, not all capabilities are output.  Mandatory padding is not
  96.      supported.  Because _tttt_eeee_rrrr_mmmm_cccc_aaaa_pppp strings are not as flexible, it is not always
  97.      possible to convert a _tttt_eeee_rrrr_mmmm_iiii_nnnn_ffff_oooo string capability into an equivalent
  98.      _tttt_eeee_rrrr_mmmm_cccc_aaaa_pppp format.  A subsequent conversion of the _tttt_eeee_rrrr_mmmm_cccc_aaaa_pppp file back into
  99.      _tttt_eeee_rrrr_mmmm_iiii_nnnn_ffff_oooo format will not necessarily reproduce the original _tttt_eeee_rrrr_mmmm_iiii_nnnn_ffff_oooo
  100.      source.
  101.  
  102.      Some common _tttt_eeee_rrrr_mmmm_iiii_nnnn_ffff_oooo parameter sequences, their _tttt_eeee_rrrr_mmmm_cccc_aaaa_pppp equivalents, and
  103.      some terminal types which commonly have such sequences, are:
  104.  
  105.           _tttt_eeee_rrrr_mmmm_iiii_nnnn_ffff_oooo                    _tttt_eeee_rrrr_mmmm_cccc_aaaa_pppp   Representative Terminals
  106.  
  107.           _%%%%_pppp_1111_%%%%_cccc                       _%%%%_....        adm
  108.           _%%%%_pppp_1111_%%%%_dddd                       _%%%%_dddd        hp, ANSI standard, vt100
  109.           _%%%%_pppp_1111_%%%%_''''_xxxx_''''_%%%%_++++_%%%%_cccc                 _%%%%_++++_xxxx       concept
  110.           _%%%%_iiii                          _%%%%_iiii        ANSI standard, vt100
  111.           _%%%%_pppp_1111_%%%%_????_%%%%_''''_xxxx_''''_%%%%_>>>>_%%%%_tttt_%%%%_pppp_1111_%%%%_''''_yyyy_''''_%%%%_++++_%%%%_;;;;    _%%%%_>>>>_xxxx_yyyy      concept
  112.           _%%%%_pppp_2222 is printed before _%%%%_pppp_1111   _%%%%_rrrr        hp
  113.  
  114.    UUUUsssseeee==== OOOOppppttttiiiioooonnnn [[[[----uuuu]]]]
  115.      _----_uuuu      produces a _tttt_eeee_rrrr_mmmm_iiii_nnnn_ffff_oooo source description of the first terminal
  116.              _t_e_r_m_n_a_m_e which is relative to the sum of the descriptions given
  117.              by the entries for the other terminals _t_e_r_m_n_a_m_e_s.  It does this
  118.              by analyzing the differences between the first _t_e_r_m_n_a_m_e and the
  119.              other _t_e_r_m_n_a_m_e_s and producing a description with _uuuu_ssss_eeee_==== fields for
  120.              the other terminals.  In this manner, it is possible to retrofit
  121.              generic terminfo entries into a terminal's description.  Or, if
  122.              two similar terminals exist, but were coded at different times or
  123.              by different people so that each description is a full
  124.              description, using _iiii_nnnn_ffff_oooo_cccc_mmmm_pppp will show what can be done to change
  125.              one description to be relative to the other.
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. iiiinnnnffffooooccccmmmmpppp((((1111MMMM))))                                                        iiiinnnnffffooooccccmmmmpppp((((1111MMMM))))
  137.  
  138.  
  139.  
  140.      A capability will get printed with an at-sign (@) if it no longer exists
  141.      in the first _t_e_r_m_n_a_m_e, but one of the other _t_e_r_m_n_a_m_e entries contains a
  142.      value for it.  A capability's value gets printed if the value in the
  143.      first _t_e_r_m_n_a_m_e is not found in any of the other _t_e_r_m_n_a_m_e entries, or if
  144.      the first of the other _t_e_r_m_n_a_m_e entries
  145.      that has this capability gives a different value for the capability than
  146.      that in the first _t_e_r_m_n_a_m_e.
  147.  
  148.      The order of the other _t_e_r_m_n_a_m_e entries is significant.  Since the
  149.      terminfo compiler _tttt_iiii_cccc does a left-to-right scan of the capabilities,
  150.      specifying two _uuuu_ssss_eeee_==== entries that contain differing entries for the same
  151.      capabilities will produce different results
  152.      depending on the order that the entries are given in.  _iiii_nnnn_ffff_oooo_cccc_mmmm_pppp will flag
  153.      any such inconsistencies between the other _t_e_r_m_n_a_m_e entries as they are
  154.      found.
  155.  
  156.      Alternatively, specifying a capability _a_f_t_e_r a _uuuu_ssss_eeee_==== entry that contains
  157.      that capability will cause the second specification to be ignored.  Using
  158.      _iiii_nnnn_ffff_oooo_cccc_mmmm_pppp to recreate a description can be a useful check to make sure that
  159.      everything was specified correctly in the original source description.
  160.  
  161.      Another error that does not cause incorrect compiled files, but will slow
  162.      down the compilation time, is specifying extra _uuuu_ssss_eeee_==== fields that are
  163.      superfluous.  _iiii_nnnn_ffff_oooo_cccc_mmmm_pppp will flag any other _t_e_r_m_n_a_m_e _uuuu_ssss_eeee_==== fields that were
  164.      not needed.
  165.  
  166.    OOOOtttthhhheeeerrrr OOOOppppttttiiiioooonnnnssss [[[[----ssss dddd||||iiii||||llll||||cccc]]]] [[[[----vvvv]]]] [[[[----VVVV]]]] [[[[----1111]]]] [[[[----wwww _w_i_d_t_h]]]]
  167.      _----_ssss      sorts the fields within each type according to the argument
  168.              below:
  169.  
  170.              _dddd    leave fields in the order that they are stored in the
  171.                   _t_e_r_m_i_n_f_o database.
  172.  
  173.              _iiii    sort by _t_e_r_m_i_n_f_o name.
  174.  
  175.              _llll    sort by the long C variable name.
  176.  
  177.              _cccc    sort by the _t_e_r_m_c_a_p name.
  178.  
  179.              If the _----_ssss option is not given, the fields printed out will be
  180.              sorted alphabetically by the _tttt_eeee_rrrr_mmmm_iiii_nnnn_ffff_oooo name within each type,
  181.              except in the case of the _----_CCCC or the _----_LLLL options, which cause the
  182.              sorting to be done by the _tttt_eeee_rrrr_mmmm_cccc_aaaa_pppp name or the long C variable
  183.              name, respectively.
  184.  
  185.      _----_vvvv      prints out tracing information on standard error as the program
  186.              runs.
  187.  
  188.      _----_VVVV      prints out the version of the program in use on standard error
  189.              and exit.
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. iiiinnnnffffooooccccmmmmpppp((((1111MMMM))))                                                        iiiinnnnffffooooccccmmmmpppp((((1111MMMM))))
  203.  
  204.  
  205.  
  206.      _----_1111      causes the fields to be printed out one to a line.  Otherwise,
  207.              the fields will be printed several to a line to a maximum width
  208.              of 60 characters.
  209.  
  210.      _----_wwww      changes the output to _w_i_d_t_h characters.
  211.  
  212.    CCCChhhhaaaannnnggggiiiinnnngggg DDDDaaaattttaaaabbbbaaaasssseeeessss [[[[----AAAA _d_i_r_e_c_t_o_r_y]]]] [[[[----BBBB _d_i_r_e_c_t_o_r_y]]]]
  213.      The location of the compiled _tttt_eeee_rrrr_mmmm_iiii_nnnn_ffff_oooo database is taken from the
  214.      environment variable _TTTT_EEEE_RRRR_MMMM_IIII_NNNN_FFFF_OOOO .  If the variable is not defined, or the
  215.      terminal is not found in that location, the system _tttt_eeee_rrrr_mmmm_iiii_nnnn_ffff_oooo database,
  216.      usually in _////_uuuu_ssss_rrrr_////_ssss_hhhh_aaaa_rrrr_eeee_////_llll_iiii_bbbb_////_tttt_eeee_rrrr_mmmm_iiii_nnnn_ffff_oooo, will be used.  The options _----_AAAA and _----_BBBB
  217.      may be used to override this location.  The _----_AAAA option will set _TTTT_EEEE_RRRR_MMMM_IIII_NNNN_FFFF_OOOO
  218.      for the first _t_e_r_m_n_a_m_e and the _----_BBBB option will set _TTTT_EEEE_RRRR_MMMM_IIII_NNNN_FFFF_OOOO for the other
  219.      _t_e_r_m_n_a_m_e_s.  With this, it is possible to compare descriptions for a
  220.      terminal with the same name located in two different databases.  This is
  221.      useful for comparing descriptions for the same terminal created by
  222.      different people.
  223.  
  224. FFFFIIIILLLLEEEESSSS
  225.      _////_uuuu_ssss_rrrr_////_ssss_hhhh_aaaa_rrrr_eeee_////_llll_iiii_bbbb_////_tttt_eeee_rrrr_mmmm_iiii_nnnn_ffff_oooo_////_????_////_****    Compiled terminal description database.
  226.  
  227. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  228.      _cccc_uuuu_rrrr_ssss_eeee_ssss(3X), _cccc_aaaa_pppp_tttt_oooo_iiii_nnnn_ffff_oooo(1M), _tttt_eeee_rrrr_mmmm_iiii_nnnn_ffff_oooo(4), _tttt_iiii_cccc(1M)
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.                                                                         PPPPaaaaggggeeee 4444
  262.  
  263.  
  264.  
  265.